# -*- coding: utf-8 -*-

# Python3 输入和输出

## 输出格式美化
'''Python两种输出值的方式: 表达式语句和 print() 函数。

第三种方式是使用文件对象的 write() 方法，标准输出文件可以用 sys.stdout 引用。
如果你希望输出的形式更加多样，可以使用 str.format() 函数来格式化输出值。

如果你希望将输出的值转成字符串，可以使用 repr() 或 str() 函数来实现。
str()： 函数返回一个用户易读的表达形式。
repr()： 产生一个解释器易读的表达形式。
'''
s = 'Hello, Python'
print(str(s))
print(repr(s))
print(str(1/7))
print(repr(1/7))

x = 10 * 3.25
y = 200 * 200
s = 'x 的值为： ' + repr(x) + ',  y 的值为：' + repr(y) + '...'
print(s)
### repr() 函数可以转义字符串中的特殊字符，其参数可以是 Python 的任何对象
print(repr('hello, Python\n'))
print(repr((x, y, ('Google', 'Runoob'))))
print(repr([x, y, ['Google', 'Runoob']]))
### 输出一个平方与立方的表
for x in range(1, 11):
    print(repr(x).rjust(2), repr(x * x).rjust(3), end=' ')    # 每列间的空格由 print() 添加（end=' '）。
    # 注意前一行 'end' 的使用
    print(repr(x * x * x).rjust(4))                           # 字符串的 rjust() 方法, 可以将字符串靠右, 在左边填充空格。
print("------------------------")
'''还有类似rjust的方法, 
如 ljust() 和 center()。 这些方法并不会写任何东西, 它们仅仅返回新的字符串
另一个方法 zfill(), 它会在数字的左边填充 0。
'''
print('12'.zfill(5))            # 00012
print('-3.14'.zfill(7))         # -003.14 负号 - 也占一位
print('3.14159265359'.zfill(5)) # 数字本身已超过5位，无需补零
print("------------------------")
for x in range(1, 11):
    print('{0:2d} {1:3d} {2:4d}'.format(x, x * x, x * x * x)) # str.format() 函数来格式化输出值
print("------------------------")
### str.format()
'''
括号及其里面的字符 (称作格式化字段) 将会被 format() 中的参数替换。
在括号中的数字用于指向传入对象在 format() 中的位置。
'''
print('{}网址： "{}!"'.format('百度', 'www.baidu.com'))
print('{0} 和 {1}'.format('Google', 'Python'))
print('{1} 和 {0}'.format('Google', 'Python'))
### 如果在 format() 中使用了关键字参数, 那么它们的值会指向使用该名字的参数。
print('{name}网址： {site}'.format(name='百度', site='www.baidu.com'))
### 位置及关键字参数可以任意的结合
print('站点列表 {0}, {1}, 和 {other}。'.format('Google', 'Python', other='Taobao'))
### '!a' (使用 ascii()), '!s' (使用 str()) 和 '!r' (使用 repr()) 可以用于在格式化某个值之前对其进行转化。
import math
print('常量 PI 的值近似为： {}。'.format(math.pi))
print('常量 PI 的值近似为： {!r}。'.format(math.pi))
print('ASCII： {!a}。'.format("中国666aaa+%\n"))
print('str  ： {!s}。'.format("中国666aaa+%\n"))
print('repr ： {!r}。'.format("中国666aaa+%\n"))
### 可选项 ':' 和格式标识符可以跟着字段名/字段位置。这就允许对值进行更好的格式化。
print('常量 PI 的值近似为 {0:.3f}。'.format(math.pi))       # 将 Pi 保留到小数点后三位：
### 在 : 后传入一个整数, 可以保证该域至少有这么多的宽度。用于美化表格时很有用。
table = {'Google': 1, 'Runoob': 2, 'Taobao': 3}
for name, number in table.items():
    print('{0:10} ==> {1:10d}'.format(name, number))
print("------------------------")
### 如果你有一个很长的格式化字符串, 而你不想将它们分开, 那么在格式化时通过变量名而非位置会是很好的选择。
print('Runoob: {0[Runoob]:d}; Google: {0[Google]:d}; Taobao: {0[Taobao]:d}'.format(table))
### 也可以通过在 table 变量前使用 '**' 来实现相同的功能：
print('Runoob: {Runoob:d}; Google: {Google:d}; Taobao: {Taobao:d}'.format(**table))
print("------------------------")

## 旧式字符串格式化
#### % 操作符也可以实现字符串格式化。它将左边的参数作为类似 sprintf() 式的格式化字符串, 而将右边的代入, 然后返回格式化后的字符串。
print('常量 PI 的值近似为：%5.3f。' % math.pi)
'''
因为 str.format() 是比较新的函数， 大多数的 Python 代码仍然使用 % 操作符。
但是因为这种旧式的格式化最终会从该语言中移除, 应该更多的使用 str.format()。
'''
print("------------------------")

## 读取键盘输入
'''
Python提供了 input() 内置函数从标准输入读入一行文本，默认的标准输入是键盘。
input 可以接收一个Python表达式作为输入，并将运算结果返回。
'''
#str = input("请输入：");
#print ("你输入的内容是: ", str)

## 读和写文件
'''
open() 将会返回一个 file 对象，基本语法格式如下:
open(filename, mode)

filename ：包含了你要访问的文件名称的字符串值。
mode     ：决定了打开文件的模式：只读，写入，追加等（非必须的），默认文件访问模式为只读(r)。
'''
'''不同模式打开文件的完全列表：
r	以只读方式打开文件。文件的指针将会放在文件的开头。这是默认模式。
rb	以二进制格式打开一个文件用于只读。文件指针将会放在文件的开头。
r+	打开一个文件用于读写。文件指针将会放在文件的开头。
rb+	以二进制格式打开一个文件用于读写。文件指针将会放在文件的开头。
w	打开一个文件只用于写入。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。
wb	以二进制格式打开一个文件只用于写入。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。
w+	打开一个文件用于读写。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。
wb+	以二进制格式打开一个文件用于读写。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。
a	打开一个文件用于追加。如果该文件已存在，文件指针将会放在文件的结尾。也就是说，新的内容将会被写入到已有内容之后。如果该文件不存在，创建新文件进行写入。
ab	以二进制格式打开一个文件用于追加。如果该文件已存在，文件指针将会放在文件的结尾。也就是说，新的内容将会被写入到已有内容之后。如果该文件不存在，创建新文件进行写入。
a+	打开一个文件用于读写。如果该文件已存在，文件指针将会放在文件的结尾。文件打开时会是追加模式。如果该文件不存在，创建新文件用于读写。
ab+	以二进制格式打开一个文件用于追加。如果该文件已存在，文件指针将会放在文件的结尾。如果该文件不存在，创建新文件用于读写。
'''
'''
基本的模式|    r    r+    w    w+    a    a+
-------------------------------------------
读读读读读|    +    +          +          +
写写写写写|         +     +    +     +    +
创建创建建|               +    +     +    +
覆盖覆盖盖|               +    +           
指针在开始|    +    +     +    +           
指针在结尾|                          +    +
'''
filePath = "../resource/foo.txt"
### 打开一个文件，默认编码依据操作系统。
f = open(filePath, "w")
f.write( "Python 是一个非常好的语言。\n是的，的确非常好!!\n" )
### 关闭打开的文件
f.close()

## 文件对象的方法
### f.read(size)
f = open(filePath) # 默认(r)只读
str = f.read()
'''
f.read(size), 将读取一定数目的数据, 然后作为字符串或字节对象返回。
size : 是一个可选的数字类型的参数。 当 size 被忽略了或者为负, 那么该文件的所有内容都将被读取并且返回。
'''
print(str)
f.close()
print("------------------------")
### f.readline()
'''
f.readline() 会从文件中读取单独的一行。换行符为 '\n'。
f.readline() 如果返回一个空字符串, 说明已经已经读取到最后一行。
'''
f = open(filePath, "r")
str = f.readline()
print(str)
f.close()
print("------------------------")
### f.readlines(hint)
'''
f.readlines(hint) 将返回该文件中包含的所有行。
如果设置可选参数 hint, 则读取指定长度的字节, 并且将这些字节按行分割。
'''
f = open(filePath, "r")
str = f.readlines()
print(str)
f.close()
print("------------------------")
### 迭代一个文件对象然后读取每行
f = open(filePath, "r")
for line in f:
    print(line, end='')
f.close()
print()
print("------------------------")
### f.write()
'''
f.write(string) 将 string 写入到文件中, 然后返回写入的字符数。
'''
f = open(filePath, "w")
num = f.write( "[new]Python 是一个非常好的语言。\n是的，的确非常好!!\n" )
print(num)
f.close()
print("------------------------")
### 如果要写入非字符串, 那么将需要先进行转换:
f = open(filePath, "w")
value = ('www.baidu.com', 14)
ss = repr(value)
print(ss)
num = f.write(ss)
print(num)
f.close()
print("------------------------")
### f.tell()
'''
f.tell() 返回文件对象当前所处的位置, 它是从文件开头开始算起的字节数。
'''
f = open(filePath, "rb+")
print(f.tell())
f.write(b'0123456789abcdef')
### f.seek()
'''
如果要改变文件当前的位置, 可以使用 f.seek(offset, from_what) 函数。
from_what 的值, 如果是 0（默认）表示开头, 如果是 1 表示当前位置, 2 表示文件的结尾。
例如：
seek(x,0) ： 从起始位置即文件首行首字符开始移动 x 个字符
seek(x,1) ： 表示从当前位置往后移动x个字符
seek(-x,2)： 表示从文件的结尾往前移动x个字符
'''
f.seek(3)           # 移动到第4个字节
print(f.tell())
print(f.read(1))
f.seek(-3, 1)       # 移动到倒数第3字节
print(f.read(1))
print(f.tell())
f.close()
print("------------------------")
'''
在文本文件中 (那些打开文件的模式下没有 b 的), 只会相对于文件起始位置进行定位。
当你处理完一个文件后, 调用 f.close() 来关闭文件并释放系统的资源，如果尝试再调用该文件，则会抛出异常。
'''
'''
当处理一个文件对象时, 使用 with 关键字是非常好的方式。在结束后, 它会帮你正确的关闭文件。 
而且写起来也比 try - finally 语句块要简短。
'''
with open(filePath, 'r') as f:
    read_data = f.read();
### with 会帮我们正确的关闭文件
print(f.closed)
print("------------------------")

## pickle 模块
'''python的 pickle 模块实现了基本的数据序列和反序列化。
通过pickle模块的序列化操作我们能够将程序中运行的对象信息保存到文件中去，永久存储。
通过pickle模块的反序列化操作，我们能够从文件中创建上一次程序保存的对象。

基本接口：
pickle.dump(obj, file, [,protocol])

obj: 要持久化保存的对象；
file: 一个拥有 write() 方法的对象，并且这个 write() 方法能接收一个字符串作为参数。
    这个对象可以是一个以写模式打开的文件对象或者一个 StringIO 对象，或者其他自定义的满足条件的对象。
protocol: 这是一个可选的参数，默认为 0 ，如果设置为 1 或 True，则以高压缩的二进制格式保存持久化后的对象，否则以ASCII格式保存。
'''
### 注解：从 file 中读取一个字符串，并将它重构为原来的python对象。
import pickle
dataFile = "../resource/data.pkl"
data = {'a': [1, 2.0, 3, 4 + 6j],
         'b': ('string', u'Unicode string'),
         'c': None}  # 使用pickle模块将数据对象保存到文件
selfref_list = [1, 2, 3]
selfref_list.append([{}, ["中", "国"], ("China", "Great")])
print(data)
print(selfref_list)
output = open(dataFile, 'wb')
pickle.dump(data, output)               # Pickle dictionary using protocol 0.
### 可以 dump 多个对象到一个文件对象中
pickle.dump(selfref_list, output, -1)   # Pickle the list using the highest protocol available.
output.close()
print("------------------------")
### 使用 pickle 模块从文件中重构 python 对象
import pprint
pkl_file = open(dataFile, 'rb')
data1 = pickle.load(pkl_file)
'''
pprint module 提供了可以按照某个格式正确的显示python已知类型数据的一种方法，这种格式可被解析器解析, 又很易读。
但是，如果已知格式的数据对象不是python的基础类型，这种表示方法就有可能加载失败。
这种情况一般是对象为 files, sockets, classes, or instances are included, as well as many other built-in objects which are not representable as Python constants。

该方法输出将对象的输出分隔成单行显示，并在宽度设置不适合时，将其分成多行显示。
'''
pprint.pprint(data1)
data2 = pickle.load(pkl_file)
pprint.pprint(data2)
pkl_file.close()

# OS 文件/目录方法
'''
os 模块提供了非常丰富的方法用来处理文件和目录
可参考： https://www.runoob.com/python3/python3-os-file-methods.html
'''